home *** CD-ROM | disk | FTP | other *** search
/ BMUG PD-ROM BV3 / BMUG PD-ROM Version BV3 (CDRM1097900).iso / Telecom / Utilities / *P*toDisk4.0.1 / Read Me < prev   
Text File  |  1992-02-18  |  18KB  |  228 lines

  1. Introduction
  2.  
  3. *P*toDisk 4.0--a shareware program--is a combination INIT and FKEY that is compatible with Finder, Multifinder, and System 7.0.  It is an upgrade from the previous version 3.2 which offers several additional features.
  4.  
  5.  
  6. *P*toDisk 4.0 Features (an asterisk indicates a new feature for this version)
  7.  
  8. 1.    Diverts Prodigy PRINT/COPY data to up to five destinations simultaneously.
  9. 2.    Allows adding to existing files as well as creating new files.
  10. 3.  Allows access to an unlimited number of files during a Prodigy session.
  11. 4.  Is small and fast.
  12. 5.  Is compatible with Multifinder, Finder, and System 7.0
  13. 6.  Is always there (no need to remember to run a DA before logging on).
  14. 7.  Offers a "type-ahead" option to speed up Prodigy access on older Macs.
  15. 8.    Allows upload of TEXT files from disk into Prodigy messages, bulletins, and replies.
  16. 9.    Offers keyboard equivalents for all *P*toDisk dialog box functions.
  17. 10.    Allows user selection of the owning application for all future newly created files.
  18. 11.    *Allows continuation of a previous Upload which required more than 6 Prodigy pages.
  19. 12.  *Provides an alternate upload filter for "choppy" messages.
  20. 13.  *Provides a hot-key (Option-a) to immediately clear the Type-ahead buffer.
  21. 14.    *For System 7 users only:  allows switching to the Finder (and from Finder to other applications) while Prodigy is running.
  22.  
  23.  
  24. Installing *P*toDisk 4.0
  25.  
  26. NOTE to *P*toDisk version 1.0, 1.1, and 1.2 users:  the two versions will not work together.  Before installing *P*toDisk 4.0, use Font/DA Mover (or your DA handling utility) to Remove *P*toDisk version 1.0, 1.1, or 1.2.
  27.  
  28. NOTE to *P*toDisk version 2 and 3 users:  the two versions will not work together.  Before installing *P*toDisk 4.0, completely de-install *P*toDisk version 2 or 3.
  29.  
  30.  
  31. 1.  Install the INIT named *P*toDisk
  32.  
  33. Drag *P*toDisk into the "System Folder" on the startup disk you use with Prodigy (if you run System 7.0, place the INIT into the Extensions folder), then copy (Option-drag) it into PRODIGY® service folder 1.  However, if you use an INIT handling utility, consult its documentation for installation details.  The copy in PRODIGY® service folder 1 is always required.
  34.  
  35. 2.  Install the FKEY found in *P*toDisk FKEY
  36.  
  37. The FKEY, which comes set for command-shift-9, can be installed in one of the following ways.  
  38.  
  39. (a)  Suitcase II or other FKEY handlers/installers -- Many are available on AOL and other BBSs (FKEY Mover by Andrew Welch works just like FONT/DA Mover and is recommended).  Follow the instructions for your installer.  Note that the *P*FKEY usually must have an ID between 5 and 9 to be accessible from within Prodigy.
  40.  
  41. (b)  Resedit -- [Note:  if you feel uncomfortable using Resedit on your System file, you should use another method to install the *P*toDisk FKEY instead of Resedit.]  Copy the *P*FKEY FKEY from *P*toDisk FKEY and paste it into the FKEY resource of the System file on the startup disk you use with Prodigy.  You may want to change the ID of the FKEY (using Get Info) before copying it from *P*toDisk FKEY if command-shift-9 is already in use on your MAC.
  42.  
  43. 3.  Configure Prodigy to repaint the screen (System 7 users only)
  44.  
  45. Using TeachText (or your word processor) open CONFIG.SM (which is in PRODIGY® service folder 1).  Find the line which begins with "printer:".  Insert a new line above it so it looks like this:
  46.  
  47. repaint key r
  48. printer:none
  49.  
  50. (Note that the letters following printer:  may be different in your system and should not be changed).
  51. (Note also that some CONFIG.SM files may not contain a "printer:" line at all.  In this case, add the new line above the "prntype:" line).
  52.  
  53. Leave everything else as it was.  Save CONFIG.SM and quit.
  54.  
  55. 4.  Choose Restart from the Special menu
  56.  
  57. You must "Restart" your MAC so the *P*toDisk INIT will run.
  58.  
  59.  
  60. Using *P*toDisk 4.0
  61.  
  62. After you open Prodigy, *P*toDisk is in the background ready to help you enhance your Prodigy session.  To use *P*toDisk, you must first type command-shift-9 which will display the *P*toDisk dialog box in front of Prodigy's screen.  Now you are ready to open files to receive Prodigy print data, to enable keyboard buffering, to open a TEXT file for uploading, or for System 7 users, to switch to the Finder.  Clicking the OK button removes the dialog box and returns you to your Prodigy session.
  63.  
  64.  
  65. Printing to Disk
  66.  
  67. When you first log on to Prodigy, *P*toDisk will allow all of Prodigy's PRINT and COPY data to go to your printer as it would were *P*toDisk not installed.  To change this, invoke the FKEY you installed above.
  68.  
  69. The FKEY will cause the dialog box to be displayed.  The first time you see the dialog box in a Prodigy session, the box for "Printer" will be checked and the boxes for the four "***available***" file slots will not be checked.
  70.  
  71. To OPEN a file to receive print data, click on one of the buttons "Create new file" or "Extend old file."  If you want to create a brand new file, click the "Create new file" button (but see "Owner for new files" below).  If you want to add data to a file which already exists, click the "Extend old file" button.
  72.  
  73. As a result of clicking one of these two buttons, you will see a box which will allow you to choose the file.  If you clicked "Create new file," you will be expected to type the name for this new file (after selecting the desired folder).  If you clicked "Extend old file," you will be expected to double-click on the name of an existing file in some folder on one of your disks.  Only files of type "TEXT" will be displayed for you to choose from.  After you enter your file choice, the box will disappear and the *P*toDisk dialog box will again be visible.  The name of the chosen file will appear in the topmost file slot, replacing "***available***."  Its check box will be checked automatically and if this is the first file you have opened in this Prodigy session, the Printer box will be automatically unchecked.
  74.  
  75. You can choose up to four different files in this way, to be open at the same time, and by clicking on the checkbox(es) of any combination of the four files and your printer, can direct the PRINT/COPY data wherever desired.
  76.  
  77. You can CLOSE any of the four open files by clicking on the "Close" button to the right of the file's name.  When you click on a file's "Close" button, that file is closed, and the file slot will display "***available***."  You can then open another file in that slot.
  78.  
  79. The file produced by *P*toDisk is a "vanilla" text file, with a carriage return (hex 0D) following each print line.  New files created by *P*toDisk have a  file type of "TEXT" and a file owner of "EDIT" (but see "Owner for new files" below).  "TEXT" files extended by *P*toDisk retain the file ownership they had before they were opened.  When Prodigy sends print lines with trailing spaces, these spaces are removed before the line is written to the disk file.  All word processing applications should have options to allow opening text files.
  80.  
  81. Note:  *P*toDisk is driven by Prodigy printing to your printer.  If you check the Printer and file(s) boxes, but your printer is not powered on, *P*toDisk will not write to the file(s).  If the Printer box is unchecked, *P*toDisk will write to the file(s) whether or not the printer is powered on.
  82.  
  83.  
  84. Owner for new files
  85.  
  86. As *P*toDisk 4.0 is shipped, any new file you create with it will be owned by the program "Edit."  This means when you double click on the file, your Mac will look for an application called "Edit" to launch in order to display the file.  If you would like to change the application that is launched when you double click on a new file, click on the text in the dialog box which says "Owner for all NEW files" or on "Edit."  This will open a box to let you choose your preferred application.  Double click on it (e.g. Word, WriteNow, MacWrite, TeachText, etc.) and the dialog box will then show your choice.  From that point until you change it again, double clicking on new files that you created with *P*toDisk 4.0 will cause that application to be launched.  This feature has no effect on files you extend nor on any other "old" files.
  87.  
  88.  
  89. Uploading Prodigy messages, bulletins, and replies
  90.  
  91. A file to be uploaded must be a TEXT file containing only letters, numbers, signs, and carriage returns; tabs will be ignored.  If your TEXT file requires more than 6 Prodigy pages, you will have the option to continue it in a new Prodigy message.  See the following section "Suppress returns on upload" for information about filtering options.
  92.  
  93. To upload a TEXT file:
  94. 1. place Prodigy's cursor where the first letter of the file should go.
  95. 2. open the *P*toDisk dialog box
  96. 3. click on Upload TEXT file
  97. 4. open the file you wish to upload, a beep means file-too-big, or file empty.  The maximum file size is 32K.
  98. 5. The file will be inserted into the message, bulletin, or reply.  All pages and overlapping words will be handled automatically.
  99. 6.  To ABORT the upload, press any key on the keyboard.
  100.  
  101. To continue a file which required more than 6 Prodigy pages:
  102. 1. place Prodigy's cursor where the first letter of the continuation should go.
  103. 2. open the *P*toDisk dialog box
  104. 3. click on Resume upload
  105. 4. The rest of the file will be inserted into the message, bulletin, or reply.  All pages and overlapping words will be handled automatically.
  106. 5.  To ABORT the continued upload, press any key on the keyboard.
  107.  
  108. Please note that YOU must fill in the "TO" and "SUBJECT" fields for the continuation of a message and place the cursor where you want the continuation of the text to go before clicking on the "Resume" button.
  109.  
  110. Miscellaneous:
  111. 1. The mouse works while the file is being uploaded.  Clicking the mouse will reposition Prodigy's cursor and therefore the data being uploaded.
  112. 2.  You will get best results if you save the file you intend to upload as plain TEXT, not "TEXT with line endings."
  113.  
  114.  
  115. Suppress returns on upload
  116.  
  117. Data to be uploaded into Prodigy messages, bulletins, and replies can come from many sources.  Some of this data can format incorrectly when uploaded to Prodigy.  To help with this situation, *P*toDisk offers two different methods of handling upload text.  These methods are selected by clicking on the message "(Suppress-returns is off)" in the *P*toDisk dialog box to toggle between them.  Following are the recommended uses for each:
  118.  
  119. (Suppress-returns is off)
  120. (1) TEXT files created in your word processor as plain TEXT
  121. (2) a previously downloaded Prodigy message (40 character line) being uploaded into a new Prodigy message (40 character line)
  122. (3) a previously downloaded Prodigy bulletin or reply (60 character line) being uploaded into a new Prodigy bulletin or reply (60 character line)
  123. (4) any text data which has returns at the ends of paragraphs but not at the end of each line
  124.  
  125. (Suppress-returns is on)
  126. (1) TEXT files created in your word processor as TEXT with line endings
  127. (2) a previously downloaded Prodigy message (40 character line) being uploaded into a new Prodigy bulletin or reply (60 character line)
  128. (3) a previously downloaded Prodigy bulletin or reply (60 character line) being uploaded into a new Prodigy message (40 character line)
  129. (4) any text data which has returns at the end of each line
  130.  
  131. If an upload is not being formatted satisfactorily with one option, clear the message or bulletin and retry the upload with the other option.
  132.  
  133.  
  134. Type-ahead
  135.  
  136. *P*toDisk's type-ahead option changes the way Prodigy treats your keystrokes and mouse clicks, making Prodigy a little more Mac-like.  When "(Type-ahead is off)" is displayed in the top right corner of the *P*toDisk dialog box, Prodigy will "forget" any keystrokes or clicks that you did before Prodigy finished its previous activity (this is how Prodigy works without *P*toDisk).  If you click on "(Type-ahead is off)" it will change to "(Type-ahead is on)" and any keystrokes or clicks that you do before Prodigy is ready for them will be saved and presented to Prodigy when it is ready.  When "(Type-ahead is on)" you can type/click one or more screens in advance.  For example, if you want to look up the article on "music" in Prodigy's Encyclopedia you would type:
  137.  
  138.    J [return]
  139.    enc [return]
  140.    music [return]
  141.    [return]
  142.    [return]
  143.  
  144. If "(Type-ahead is off)" you must wait after each [return] until Prodigy has completed displaying the response screen.  If "(Type-ahead is on)" you can type everything continuously, and Prodigy will receive each command when it is ready.  *P*toDisk retains your type-ahead setting through multiple Prodigy sessions.
  145.  
  146. The current type-ahead operation can be aborted by typing Option-a.  If "(Type-ahead is on)" and you discover that something that you typed unintentionally is taking Prodigy "where no one has gone before," type Option-a and the type-ahead buffer will be discarded immediately.  Typing Option-a does not affect the status of type-ahead.  If "(Type-ahead is off)" and you type Option-a, Prodigy will beep at you as you would expect.
  147.  
  148. Warning:  Macros created with QuicKeys without type-ahead will probably cause problems when used with type-ahead on.  This problem does not occur with MacroMaker.
  149.  
  150.  
  151. Finder
  152.  
  153. System 7 users have the option of switching to the Finder and back during a Prodigy session.
  154.  
  155. To switch to the Finder:
  156. 1.  open the *P*toDisk dialog box
  157. 2.  click the Finder button (this button is dimmed and unavailable on those Macs running a system earlier than System 7)
  158.  
  159. To return to Prodigy:
  160. Use the application menu in the upper right corner of your menu bar to select Prodigy or double click on the Prodigy application's ICON in the Finder.
  161.  
  162. Because of the way the Prodigy software was written, Prodigy's window will remain hidden whenever Prodigy is in the background.
  163.  
  164. Files that are checked for print capture in the *P*toDisk dialog box may be opened in other programs while Prodigy is in the background.  However, close these files before returning to Prodigy or *P*toDisk may not be able to add new data to them.
  165.  
  166. You will find that with the *P*toDisk 4.0 INIT installed, many application switcher utilities that would not previously work with Prodigy, will now work.
  167.  
  168.  
  169. Dialog Box Keyboard Equivalents
  170.  
  171. All dialog box functions can also be invoked from the keyboard:
  172. c or C  -  Create
  173. e or E  -  Extend
  174. f or F  -  Finder
  175. o or O  -  change Owner for new files to be created
  176. p or P  -  toggle Printer check box
  177. r or R  -  Resume upload
  178. return or enter  -  OK
  179. s or S  -  toggle Suppress-returns
  180. t or T  -  toggle Type-ahead
  181. u or U  -  Upload TEXT file
  182. 1 or 2 or 3 or 4  -  toggle check box for file 1 or 2 or 3 or 4
  183. Command+1 or 2 or 3 or 4  -  Close file 1 or 2 or 3 or 4
  184.  
  185.  
  186. Keyboard Command
  187.  
  188. Option+a - Abort current type-ahead operation (see above, under Type-ahead)
  189.  
  190.  
  191. B E E P S ! !
  192.  
  193. *P*toDisk communicates error conditions by beeping at you.  The meaning of the beep depends on what you or Prodigy are doing when it happens.  Following is a list of times when *P*toDisk might beep.
  194.  
  195. 1. System Startup time--*P*toDisk was unable to get enough system memory to initialize.  Contact me as described below.
  196.  
  197. 2. Before Prodigy Sign-on Screen--*P*toDisk was unable to get enough memory to initialize.  This should only happen on 1Meg MACs or with Multifinder.  For Multifinder, increase Prodigy's memory allowance (add 80K) in its Get Info window.  Otherwise, contact me.
  198.  
  199. 3. When you invoke the FKEY--This could be the same problem as number 2 above.  It can also be caused by the name of the copy of the *P*toDisk INIT that is in PRODIGY® service folder 1.  Check to be sure that this copy is named "*P*toDisk" (without the quotes, but with this exact capitalization and with no leading or trailing spaces).
  200.  
  201. 4. While PRINTing or COPYing--(1) *P*toDisk ran out of disk space to write the PRINT or COPY data.  If you press the FKEY, you will see that *P*toDisk has unchecked the file which ran out of space.  It is recommended that you CLOSE that file (and optionally open another one on a different disk).  It is probable that the last addition to that file is incomplete.  (2) *P*toDisk cannot find one of the files that you checked to receive print data.  Ensure that the disk where you created it is available to your Mac.  (3) System 7 users only:  a file that *P*toDisk is trying to print to is open in another application.  Switch to the Finder, close the file, return to Prodigy, open the *P*toDisk dialog box, recheck the file for printing, and reprint the data.
  202.  
  203. 5. When returning from the Finder--Ensure that you performed installation step 3 above.
  204.  
  205.  
  206. Other problems
  207.  
  208. 1. Nothing happens when you invoke the FKEY--Assuming that the *P*toDisk ICON displayed when you started your Mac, this is most commonly caused by the name of the Prodigy application.  For *P*toDisk to recognize that it is running with Prodigy, the Prodigy application must be named "PRODIGY service" (without the quotes, but with this exact capitalization and with no leading or trailing spaces).  (For System 7 users, there are no restrictions on names for aliases of the Prodigy application).
  209.  
  210. 2. *P*toDisk creates a file but it is empty--This is caused by Prodigy's unusual method of dealing with Mac printers.  Open TeachText (or your word processor), then open CONFIG.SM (found in PRODIGY® service folder 1).  You will see a line which says "printer:none."  Insert another line after it so it looks like this:
  211.  
  212. printer:none
  213. prntype:2
  214.  
  215. Do not change anything else in CONFIG.SM.  Save it and quit.  Do NOT run Prodigy's configure program after making this change or you will have to repeat the change.
  216.  
  217. ---------------------------------
  218.  
  219. Your comments and criticisms are welcomed and will be consulted for enhancements and corrections to future releases.  I can be reached on Prodigy as VFDN48A, on America Online as Restemeyer, and on Compuserve as 76150,672.
  220.  
  221. The requested shareware fee for *P*toDisk 4.0 is $15 if you downloaded it or $18 if I mailed you a disk (this includes an extra $3 for the disk, mailer, and postage).  If you have already paid for a previous release, please subtract $10 from the appropriate fee.  If you keep and use *P*toDisk 4.0, please send the fee to:
  222.  
  223.    Bill Restemeyer
  224.    240 W. 98th St.  #11C
  225.    NYC   10025
  226.  
  227. Programs and Documentation ©Bill Restemeyer, New York City, 02/03/92
  228.